Skip to main content
GET
/
v1
/
kyc
/
customers
/
{subaccountId}
Tier Two | Get Individual Information
curl --request GET \
  --url https://api.bullring.finance/v1/kyc/customers/{subaccountId} \
  --header 'x-api-key: <api-key>'
{
  "status": "incomplete",
  "rejection_reasons": [],
  "created_at": "2025-12-31T10:37:53.156Z",
  "updated_at": "2025-12-31T10:38:25.087Z",
  "type": "individual",
  "first_name": "Mike",
  "middle_name": null,
  "last_name": "Bull",
  "phone": "+2348012345678",
  "address": {
    "street_line_1": "9 Karimu Street",
    "street_line_2": "",
    "city": "Lagos",
    "state": "LA",
    "postal_code": "105102",
    "country": "NGA"
  },
  "birth_date": "1993-01-24",
  "documents": [
    {
      "purpose": "PROOF_OF_ADDRESS",
      "file": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ],
  "account_purpose": "payments_to_friends_or_family_abroad",
  "account_purpose_other": null,
  "employment_status": "employed",
  "expected_monthly_payments_usd": "FROM_5000_TO_9999",
  "acting_as_intermediary": false,
  "most_recent_occupation": "ACCOUNTANT_AND_AUDITOR",
  "source_of_funds": "inheritance",
  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "NGA",
      "number": "12345678909",
      "image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738198/verification/2025-11-21/t2fgqlxesqigmm0qfvbi.png",
      "image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
subaccountId
string<uuid>
required

The unique identifier of the subaccount

Response

Successful response

​
status
string
​
rejection_reasons
string[]
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
type
string
​
first_name
string
​
middle_name
string | null
​
last_name
string
​
phone
string

Phone number of the customer. Must be in E.164 format (e.g., +2348012345678)

​
address
object
​
birth_date
string<date>
​
documents
object[]
​
account_purpose
string
​
account_purpose_other
string | null
​
employment_status
string
​
expected_monthly_payments_usd
string
​
acting_as_intermediary
boolean
​
most_recent_occupation
string

Fetch from occupation endpoint: /api-reference/verification/get-occupations

​
source_of_funds
enum<string>
Available options:
company_funds,
ecommerce_reseller,
gambling_proceeds,
gifts,
government_benefits,
inheritance,
investments_loans,
pension_retirement,
salary,
sale_of_assets_real_estate,
savings,
someone_elses_funds
​
identifying_information
object[]